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PREFACE 


This manual provides the PDP-11/RSX-11D user with the 
information necessary to communicate with an IBM 360/370 via a 
DX11-B interface. 
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1. INTRODUCTION 


Tho DX interface subsystem controls the transfer of data bo two on 
the PDP-11 and an IBM 3bG/370 channel. The subsystem has boon designed 
to provide user interfaces which are comprehensive and easy to use. 

This manual provides a functional doacription of tho DX interface 
subsystem and describes the commands, procedures, and conventions for 
its use, Tho manual is divided into the following topics, 

Section 2 provides an overview of the subsystem. 

Section 3 provides guidelines on writing user programs which 
communicate with the IBM 36Q/37G via tho DX11-B interface. 

Section .4 describes the requirements for maintaining and using the 
DX 1 1 -D Device Handler, 

Section 5 discusses considerations for enabling the IBM 3<j0/370 to use 
the device emulated by the FDP-1 J/DXll-B. 


Section 6 is a guide for Isolating system faults, 

To aid in the complete understanding of the DX interface, the 
following documents may be helpful. 

o Digital Equipment Corporation, RSX-11D User's Guide., 

R epo rt No. DEC- 1 1 -OXDUA - A -D. 

o Digital Equipment, Corporation, RSX-iiD FORTRAN Special 

Subroutines Reference Manual, Report No, DEC-li-LFSlvtA-R-D. 

o IBM System/ 370, Principles of Opera tion, GA32-7U0Q-3. 


2 . 


GENERAL INFORMATION 


This section provides an overview of the EX interface subsystem 
which links the PDP-11 with an IBM 360/370 via a channel interface, 

2, 1 System Capabilities 

The system provides basic road/writc services between the IBM 
360/370 and the PDP-11, 

The PDP-11 emulates an IBM/2348 control unit and a 2260 device. 
However, additional capabilities have been added to the DX11-B Device 
Handler which service several channel commands associated with the 
operation of an IBM/2250 graphics station. This allows the PDP-11 
to emulate a "limited-function" IBM/2250 which does not support function 
key or light pen services. If the PDP-11 is viewed as a 2250 by the IBM 
software, all non-zero attentions from die PDP-11 must bo interpreted as 
keyboard attentions, 

2. 2 Hardware Components 

Figure 2-1 shows the minimum hardware configuration required. 
The DX11-B can be connected to either a selector, multiplexer, or 
block multiplexor channel, The DL-llC/Tektronix 4014 interface can be 
replaced by a compatible teletype interface. 

2. 3 Software Components 

Figure 2-2 shows an overview of the software components which 
compose a general DX communication system. The functions of these 
components are described "below, 

2. 3, 1 IBM Application Program 

This is a user-written program which employs the computer's 
facilities for a specific application. 

2,3,2 Access Method 

This is a set of macros and/or routines which aid the user in 
transferring data between memory and an external device. Access methods 
are normally responsible for translating a user's logical I/O request into 
the appropriate channel program. 
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Figure 2-2 








3. 3. 3 I/O Supervisor 


Tliis Is an integral part of the IBM operating system, It controls 
the scheduling of channel programs, services I/O interrupts, and performs 
I/O error recovery. 

2. 3, •! DXU - B Device Handler 

This software controls the DX11-B device hardware. It processes 
I/O requests from the PDP-11 application program, processes I/O interrupts 
from the DX11-B, and performs various control unit functions such as 
providing sense data and attention signals to the IBM channel. 

2. 3. S RSX-11 Operating System 

This software allocates the resources of die PDP-11 system. In 
particular, it directs I/O requests to the proper device handler queue, 
controls task scheduling, and coordinates event notification, 

2. 3, 6 PDP-11 Application Program 

This is a user-written program which employs the computer's 
facilities for a specific application. 
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3 , 


PROGRAMMING GUIDELINES 


This auction provides rules and suggestions for writing PDP-11 
application programs which use the DX Ihlertace services. 

3. I I/O Request Format 

AU application program requests to the DXll-B Device Handler 
are in the formof a standard OIO request. The following symbols are 
used in defining the 010 requests* 

o LUN - Logical unit number (word). 

o EEN ** Event flag number (word), 

o IOSTAT » 1/0 status block (3 Words), 

o AST - A synchronous system trap (address), 

o DUFFER - I/O buffer ("w" bytes), 

o DVTCT - Byte count (word), 

o TERM » Device dependent parameter list (6 words), 

o 1SW - Directive status return code (i word), 

The function codes (10. ATT, IO.DET, etc.) used in MACRO- 11 
interfaces are resolved by the task builder by linking to the executive 
symbol table, The function code used in the FORTRAN calls must be 
defined in the user's program. These codes are defined in Appendix I of 
the RSX-1I I/O Operations Reference Manual. 

The WTOIO form of the FORTRAN 010 call results in a synchronous 
1/0 request, i. e, , the task is suspended until live I/O request is completed. 
Hence, there is no need to specify an event flag, The WTOIO form is 
recommended for attach and detach requests. 

If the asynchronous form of the GIO call is specified, the user should 
specify an event flag number which is used in wait functions to check 
for I/O completion. In such cases logical combinations of event flags may 
be specified in various wait functions to allow the user to detect additional 
conditions. For example, the user can issue a OIO request, followed by 
a mark time request, and then wait for either the 1:0 request to complete or 
the time interval to expire. 



3.1.1 Attach DX11-B 


MACRO- 11 

QI0$S HO. ATT, #LUN, , , //IOSTAT 
FORTRAN 

CALL [WT]QIO{lQATT, LUN, , .IOSTAT, , ISW) 

3.1.2 Detach DX11-B 
MACRO- 11 

01O$S #10. DET, #LUN, , , //IOSTAT 
FORTRAN 

CALL [WT]QI0{I0DET, LUN, , , IOSTAT, , ISW) 

3. 1. 3 Hand DX11-J3 Data 
MACRO- 11 

QI0$S ffio. RLB, //LUN, //EFN, , //IOSTAT, [//AST], 
<//BUFFER, #BYTC35> 

FORTRAN 

CALLGETADR (IPRM( 1), BUFFER) 

IPRM{2)-B YTCT 

CALL [WT]QlO(IORLB, LUN, EFN, , IOSTAT, 

IPRM, ISW) 

3.1.4 Write DX 11 -B Data 
MA CRO- 1 1 

QIO$S #IO. WLB, //LUN, //EFN, , //IOSTAT, [#AST], 

<// BUFFER, #BYTCT> 

FORTRAN 

CALL GETADR (IFRM( 1 ), BUFFER) 

IPRM(2)“B YTCT 

CALL [WT]Q10(I0WLB, LUN, EFN, , IOSTAT, IPRM, ISW) 



5, 2 DX11-R Devic* ' handler Error Codes 

A succoa s ful I O request will return a value of +1 in the directive 
status word and the low order eight bits (7-01 of the first word of the 1. O 
status block. An unsuccessful IfO request will return the following code a In 
the low order eight bits of the first word of the 1.0 status block. 

Attach Request 


IE, DA A 

(-S1 

Device already attached 

Detach Request 

IE. DNA 

{ -71 

Device not attached 

Read Write Requests 


IE. IPG 

i-31 

Illegal function code 

IE. BAD 

(-1) 

Bad byte count 

IE. SPG 

i-ol 

Invalid buffer address 


t-qi 

Privilege violation 


(-31 

DX is off-line 


(~il 

Conflicting us or. TDM request 


(-51 

IBM reset occurred 


If the error code does not match one of die above, negate the error 
code and check for combinations of the following! 


.10 

Channel termination 

•10 

IBM HID 

100 

Parity 1 error 

aoo 

Non existent memory 


o, 3 Event Flay; Conventions 

Read and write requests from the IBM channel are signalled to 
the PDP-11 application program via global event flags. These flags are 
sot by* the DX11-B Device Handler only if the application program does 
not have the required I O request pending. 

The global event flags should be cleared by the application program 
upon detecting tile event. 


The following event numbers are used: 


o *U idecimaB vs used to indicate that tho application program 
should Issue a road request tlBM vs trying to wnteh 

o 42 \decmial' vs used to indicate that the application program 
should issue a write request tlBM is trying to read'. 

o S3 tdeeimall vs used to indicate that the channel has terminated 
an itwprogeosa data transfer (channel termination or HALT 
I ov. 


3,4 


The example shown in Figure 3- 1 illustrates how a user can 
utilise the PX communication services* 


The example shown is a program which routes messages between 
a Teh teonix 4014 device on the PPP-11 ami an application program on 
the IBM in'.: . \y. 

it the IBM application program writes data to the device being 
emulated hv the PPP-1 1, the PPIM1 application program detects tlie 
event, and issues a read reguest, to the PX 1 1 -1' . It then writes the received 
data to the Tektronix 4014, The write -all function code is used since the 
data from the IBM is known to contain control information for the 4014 
hardware. 


A CIO read request is kept outstanding to the Tektronix 4014 
except when data must be written to it, This read request allows data to 
be received from the 4014 without knowing whether the displayed message 
from the IBM is a prompt or an info r ma tion -onl v message* 

Note that the program writes data to the PXU-B regardless of 
whether an IBM read event has occurred* In this situation, the PX11-B 
Pevice Handler will produce an attention request to the IBM channel to 
notify the IBM 3o0 370 that there is data to be read, 


The program shown in Figure 3«J is task built bv the following comma m 
PX VFST -Or FX\ PXTFST -SF FXTKi? T 
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Figure 3-1 (Continued) 



4. 


DXll-B DEVICE HANDLER CONSIDERATIONS 

This section describes operator commands and utilities associated 
with the DXll-B Device Handler, 

4. 1 Assembling 

The following command will assemble the DXll-B Device Handler 
source codes 

MA C>DX, DX=DX 

The assembly will produce the object file DX, OBJ and the list 
file DX. LST, 

4, 2 Task Building 

The following command file will build the DXll-B Device Handler 

task; 

DX/ PR/FX/ - CP/ -FP, DX=DX, fl, ijEXEC. STB 

/ 

TASKs DX 

UIC<1,1] 

PR 1=24 8 
STACK =3?. 

// 

These commands will produce the task image file DX. TSK and 
the map file DX. MAP. 

The command file can be executed by entering; 

TKE> <$ file s pecif ier 
4. 3 Loading/ Unloading 


The DX task must be installed before the DXll-B Device Handler 
can bo loaded into memory. If the system is not saved with the DX task 
installed, enter the following command: 

MCR>INS [ulc] DX 

where "ulc" is replaced by the User Identification Code (UIC) which contains 
the file DX. TSK. 


Once installed, the DXil-D Device Handler can be loaded into 
memory by entering: 

MCR> LOA DX: 

To unload the DXU-B Device Handler enter: 

MCR>UNL DX: 

This will remove the handler from memory and place the emulated 
device off-line to the IBM 360/370. 

4. 4 System. Generation 

The following device specification should be given during system 
generation: 

DEV=DX0, <0, 0, 0, 0> , 340, 4, 176200 

This requires the DX interrupt vector to be at 340 and the DX 
CSR to be at 176200. 
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5, 


IBM CONSIDERATIONS 


This section discusses subjects relating to IBM 360/370 procedures 
for communicating with the PDP- 1 1 /DX1 1 -B. 

5. 1 Channel Considerations 


The DX11-B is a Direct Memory A ccess (DMA) device which 
can place streams of data directly into PDP-11 memory at high speed. 
Therefore, the DX11-B should normally be attached to an IBM selector 
or block multiplexer channel. 

5, 2 Device Considerations 


The DX11-B hardware and Device Handler are said to emulate an 
IBM 2848/2260 because all channel sequences associated with such a unit 
are supported. However, it is possible for die IBM to view the PDP-11 
as another type of terminal if only the basic read/write capabilities of 
the terminal arc used, and the read/write functions result in the same 
channel sequences as with an IBM 2848/2260. 

The channel commands accepted by the DX11-B hardware and 
Device Handler are listed in Figure 5-1. All other commands will return 
Unit Check to the IBM 360/370. 


SUPPORTED CHANNEL COMMANDS 


COMMAND (hexadecimal) 

0 

1 

T 

M 

3 

4 

5 

6 
7 
A 
E 


DEFINITION 

TEST I/O 
WRITE DS 
READ MI 
NO-OP 
SENSE 
WRITE LA 
READ DS 

ERASE/FREEZE CURSOR 
SHORT READ Ml 
REQUEST ATTENTION TYPE 


Figure 5-1 
-19- 


6 . 


PROBLEM CHECKLIST 


This section is provided as an aid in identifying malfunctions in 
the DX system. 

Symptoms The task DX. , . , does not appear In memory after loading 
the driver. 

Checklist! Check the. DX display light labeled ONLINB. If this light 

Is off, the DX could not be placed on-line to the IBM 360/370, 
In tliis situation the DX11-B Device Handler (DX. , . , ) 
exits during the initialisation phase. 

Verify that the IBM system is up. 

Verify that the switch at the front bottom loft of the DX11-B 
is set to the enabled position, 

Verify that the DX11-B is cabled correctly to the IBM channel, 
Symptom; Unable to attach DX11-B. 

Checklist; Verify that the task DX. ... is loaded into memory. If 

not, load the DX11-B Device Handler (LOA DX:) and check 
for the symptom described above. 

Verify that another task is not attached to DX11-B. 

Symptom: QIO read request to DX11-B never completes. 

Checklist: Check the DX light labeled DXTO. If lighted, the application 

program did not respond to an IBM road or write event flag 
within the required time period. 

Verify that the correct event flags are being waited upon. 

Verify that the application program is processing the data 
to/from the IBM in an expeditious manner. 

Check the DX display light labeled ONLINB, If not lighted, 
the IBM 360/370 has probably had a system failure. 
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Symptoms QIQ write request to the DXU-B never completes. 

Checklist} Check the DXTQ display light as specified in the previous 

checklist. 

Check the ONLINB display light as specified in the previous 
checklist. 

Verify that the required IBM software is up. 

Verify that the IBM software interprets an attention code of 
octal 40 as a keyboard attention. 
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